超简单组织AngularJS模块

作者：@MerlinRanhttp
转自：新浪云存储讨论区

去年下半年接触前端开发和AngularJS，一路跌跌撞撞，尤以模块化代码组织的教训最深刻。

最开始代码量小也没经验，直接在html引用所有js文件。后来搞得html文件越来越大，js的顺序一乱，就报奇奇怪怪的错误，找半天。

第二个项目，我就想着要改进，直奔声名显赫的RequireJS去了。但RequireJS真的很麻烦有木有！平添了许多代码，和AngularJS的Dependency Injection长得还挺像，一不小心就搞混。时不时报个Script Error出来，根本不知道问题在哪里。

有没有更简单的方法呢？正想着呢，ng-newsletter一声炮响，送来了这篇文章。作者Jeff Dickey介绍了用模块来组织代码的四种方法，依照推荐程度，依次为：

• Require.js (Implementation of AMD)
• Browserify (Implementation of CommonJS)
• Angular dependency injection
• ES6 modules

作者着重写了在第三种基础上，组织代码的简化方法（捂脸，我才用到第一种）。

模块的功用，首先是要隔离命名空间。Angular的模块机制很好地解决了。除了angular这个对象本身，没有任何暴露在Global里的对象。

然后是处理依赖关系。Angular的模块同样指定了依赖关系，而Dependency Injection在更细的粒度上做了类似的事。

更棒的是，Angular模块的定义顺序可以随便。各个service、controller、directive注册到模块的顺序，也没有限制。唯一的要求只是：模块要先定义，后使用。请看下面的例子：

// 模块可以按任意的顺序定义
angular.module('app', ['ctrl']);
angular.module('ctrl', ['svc']);
angular.module('svc', []);

// 使用尚未注册的GithubSvc
angular.module('ctrl')
.controller('GithubCtrl', function ($scope, GithubSvc) {
  GithubSvc.fetchStories().success(function (users) {
    $scope.users = users;
  });
});

angular.module('svc')
.factory('GithubSvc', function ($http) {
  return {
    fetchStories: function () {
      return $http.get('https://api.github.com/users');
    }
  };
});

可运行的代码在这个jsFiddle。

Angular没有帮我们解决的，就剩下文件加载了。既然加载顺序无关紧要，那直接把文件合并起来不就好了？反正最终都要合并的。

gulp.task('js', function () {
  gulp.src(['src/**/module.js', 'src/**/*.js'])
    .pipe(concat('app.js'))
    .pipe(gulp.dest('.'))
})

无论是按业务还是按功能划分目录，只要把每个模块的定义都放在目录下的module.js里，保证所有模块在使用之前都已经定义过了，直接concat毫无问题。html里却只有一行：

<script src="app.js"></script>

编写、测试还是按模块分目录和文件，代码组织清晰利落。拼接到一起在浏览器上跑。发布时，再ngAnnotate和uglify一下就好。

库的代码，再拼出一个vender.js就行了。gulp-bower-files这个插件，可以分析bower.json，把依赖的每个库里的main属性组合起来，创建gulp.src()。

gulp.task('vendor', function () {
  gulpBowerFiles()
    .pipe(concat('vendor.js'))
    .pipe(gulp.dest('.'))
})

每次手工gulp js不方便？gulp watch起来。

gulp.task('watch', ['js'], function () {
  gulp.watch('src/**/*.js', ['js'])
})

当然，这些都是权宜之计，因为传说中的ES6和Angular 2.0，将搞定这些问题。不过在此之前，不妨试试这个超简单的方法咯。